home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / sound / amp132.zip / AMP.TXT < prev    next >
Text File  |  1996-05-15  |  9KB  |  248 lines
  1.     ==============================================================
  2.                 A M P   1.32
  3.       The module player for Sound Blaster AWE32 and compatibles
  4.     (c) 1995-1996 by Lada Kopecky a.k.a. Grinus / Torture Of Music
  5.     ==============================================================
  6.  
  7.  
  8. FEATURES
  9.  
  10.  - plays XM modules (FT2.0x, format version $0104)
  11.  - plays S3M modules (ST3.0 - 3.21)
  12.  - plays MOD/NST modules (M.K.  FLT4  nCHN  nnCH  OCTA  N.T.)
  13.  - plays MTM modules
  14.  - plays multiple modules (using wildcards and/or listfiles)
  15.  - can play the multiple modules in a random order
  16.  - up to 32 channels and 30 sounding notes
  17.  - makes no clicks!
  18.  - the strict compatibility with the FT2.06 and ST3.21 playback routines!
  19.    (including the emulation of some bugs)
  20.  - can play in Windows, even in background!
  21.    Just increase the Priority (using PIF editor) in Windows 3.x or decrease
  22.    the Idle Sensitivity (in Properties of AMP icon) in Windows 95 to achieve
  23.    the continuous playback.
  24.    However, the background playback may be affected by running other tasks.
  25.  - supports the animated messages using sample names
  26.  - can report all suspicious events during the module load and playback, e.g.:
  27.    - invalid, unknown, unsupported and improperly used pattern effects
  28.    - data in disabled S3M channels
  29.    - the synthesizer hardware limits exceeded
  30.  - loads and plays even slightly corrupted MOD files
  31.  - fast forward mode, pattern skip in both directions
  32.  - forced tempo mode
  33.  - settings taken from AMP.INI or the command line
  34.  - can play if not enough AWE memory
  35.  - no problems with memory or extenders (66-220 KB of DOS memory is enough)
  36.  - does not change the Sound Blaster mixer settings
  37.  - and of course, the maximal sample upload speed :)
  38.  
  39.  
  40.  
  41. SWITCHES  (preceded by '/' or '-')
  42.  
  43.   V     verbose mode
  44.       - all info shown in Log window
  45.       - message colors: INFOS - white, WARNINGS - yellow, ERRORS - red
  46.  
  47.   S     single mode
  48.       - no module looping, no batch looping
  49.       - the loop detection works at the pattern level (it may fail
  50.          if the patterns are splitted into non-continuous parts)
  51.  
  52.   P     pause mode
  53.       - waits at the end of each module
  54.         (you can continue switching and scrolling the screens)
  55.  
  56.   J     jukebox mode
  57.       - modules are played in a random order
  58.       - you can combine it with the single and pause modes
  59.       - some additional DOS memory is needed for the filenames
  60.  
  61.   F     force play if not enough sample memory
  62.       - some samples will be ignored
  63.  
  64.   I     show numeric pan values 0 to F and M (instead of L/R/M)
  65.  
  66.   Xn    force the EMU8000 base port (in hex, e.g. 620 or 640)
  67.       - if you include this switch, AMP won't use the 'BLASTER' variable
  68.         nor the autodetect routine
  69.  
  70.   Nn    default panning from the middle (0..127, default 72)
  71.       - this is the initial panning of the left/right MOD/S3M channels
  72.         (something like 'n' switch in DMP player)
  73.  
  74.   Mn    initial volume 0..64 (default is the automode)
  75.       - in automode the initial volume depends on the number of channels
  76.  
  77.   Rn    initial reverb level (0..255, default 36)
  78.  
  79.   Cn    initial chorus level (0..255, default 0)
  80.  
  81.   En    reverb type (0..7, default 4)
  82.  
  83.   On    chorus type (0..7, default 0)
  84.  
  85.   Bn    initial bass level   (0..11, default 5)
  86.  
  87.   Tn    initial treble level (0..11, default 5)
  88.  
  89.      n      Bass/Treble       Reverb Type      Chorus Type
  90.     ---     -----------       -----------      -----------
  91.      0        -12 dB          Room 1           Chorus 1 (*)
  92.      1         -8 dB          Room 2           Chorus 2
  93.      2         -6 dB          Room 3           Chorus 3
  94.      3         -4 dB          Hall 1           Chorus 4
  95.      4         -2 dB          Hall 2 (*)       Feedback Delay
  96.      5          0 dB (*)      Plate            Flanger
  97.      6         +2 dB          Delay            Short Delay
  98.      7         +4 dB          Panning Delay    Short Delay Feedback
  99.      8         +6 dB
  100.      9         +8 dB
  101.     10        +10 dB
  102.     11        +12 dB
  103.  
  104.  All switches above can be used in AMP.INI, one option per line.
  105.  Command line switches take precedence over the INI file settings.
  106.  The mode switches V/F/S/P/I can be reset from the command line by appending
  107.  the minus sign (e.g. -S-).
  108.  AMP.INI must be placed in the same directory as AMP.EXE !
  109.  
  110.  
  111.  
  112. MODULES AND LISTFILES
  113.  
  114.  You can specify one or more modules and/or listfiles in the command line.
  115.  You can use wildcards in module names. The extensions may be omitted.
  116.  The listfile is the list of modules to play, one filename per line.
  117.  The lines with leading ';', '#' or space will be ignored (also in AMP.INI)
  118.  
  119.  
  120.  
  121. KEYBOARD
  122.  
  123.   F1            Help Screen
  124.   F2            Log Screen (in verbose mode only)
  125.   F3            Channels Screen
  126.   F4            Instruments Screen
  127.   PgDn PgUp     scroll channels or instruments (also Ctrl-PgUp/PgDn/Home/End)
  128.  
  129.   Enter         fadeout and the next module in batch
  130.   ->            pattern forward (the remaining pattern data are ignored)
  131.   <-            pattern back
  132.   Up            fast forward (4-times faster)
  133.   Ctrl Down/Up  forced tempo down/up (the remaining tempo changes are ignored)
  134.  
  135.   Esc           fadeout and exit to DOS
  136.   spacebar      pause/resume
  137.  
  138.   -  +          volume down/up
  139.   F5  F6        EMU equalizer bass level down/up
  140.   F7  F8        EMU equalizer treble level down/up
  141.   F9  F10       reverb level down/up
  142.   F11 F12       chorus level down/up
  143.   1-9 A-P       channel 1-25 on/off  (no more free letters)
  144.   R  S          all channels off/on
  145.  
  146.  
  147.  
  148. REQUIREMENTS
  149.  
  150.  - at least PC 286  (but not tested on 286)
  151.  - EGA/VGA
  152.  - Sound Blaster AWE32 or a compatible sound card with EMU8000
  153.     (at least 2 MB of on-board sample RAM is strongly recommended)
  154.  - no AWE32 drivers are needed
  155.  - 66..220 KB of free DOS conventional memory. No EMS/XMS used.
  156.  
  157.  
  158.  
  159. UNSUPPORTED PATTERN EFFECTS
  160.  
  161.  - Set Filter             (unsupported by ST3/FT2, Amiga HW specific one)
  162.  - Old ST Stereo Control  (unsupported by ST3, does anybody know the function?)
  163.  - Funk Repeat            (unsupported by ST3/FT2, never seen it)
  164.  - Set Finetune           (unsupported by ST3, never seen it)
  165.  
  166.  
  167.  
  168. USEFUL HINTS
  169.  
  170.  Examples of use (the default AMP.INI was assumed):
  171.  
  172.   a) To play all modules from a directory (all MOD/MTM/S3M/XM extensions):
  173.     AMP  E:\MODULES\*
  174.  
  175.   b) To play your favourite songs in random order without waiting between them:
  176.     AMP  @E:\MODULES\MY-BEST.LST  -J  -P-
  177.  
  178.   c) To play specified modules with looping enabled:
  179.     AMP  E:\MODULES\DOPE  C:\*.XM  -S-
  180.  
  181.  You can make an association of modules with AMP.EXE in your favourite
  182.  disk/file manager. Then AMP is invoked when you 'Open' or 'Start' the module.
  183.  For example, to do it in XtreeGold, create the files MOD.BAT, S3M.BAT, MTM.BAT,
  184.  and XM.BAT in a directory where Xtree resides. They can contain just a single
  185.  line like this:
  186.     @C:\SOUND\AMP\AMP.EXE  %4.%5
  187.  
  188.  
  189.  
  190. FUTURE PLANS
  191.  
  192.  - professional quality downsampling of highest samples to prevent the
  193.    EMU8000 pitch overflows and for you with less sample memory  :-)
  194.    It means the resampling with the high quality anti-aliasing filter
  195.    and with the original pitch of short-looped samples precisely preserved.
  196.  
  197.    The pitch overflows are handled by decreasing the octave in the present
  198.    versions of AMP.
  199.  
  200.  
  201.  
  202. WHAT YOU CAN'T EXPECT
  203.  
  204.  I'm not planning to implement the DOS shell and file selector...
  205.  Use Windows or OS/2 instead of DOS shell and the association of modules
  206.  with AMP (as described above). That's the way I use it. :-)
  207.  
  208.  
  209.  
  210. FOR CUBIC PLAYER USERS
  211.  
  212.  Cubic Player (up to v1.7) does not initialize the EMU chip properly.
  213.  If used after any program using the ADIP 2.52 style initialization (e.g. AMP),
  214.  some sounds are lost.
  215.  The same problem persists with AWEMP player by B.Boer (up to v1.45).
  216.  For this reason I created a simple utility called AWERESET to reset the AWE32
  217.  in the style of ADIP 2.0. You'll need it to prepare the AWE32 hardware for
  218.  Cubic Player after AMP was used. Instead of my AWERESET utility you can use
  219.  the 'AWEUTIL /S' command as well (thanx to B.Boer ;-).
  220.  NOTE: There are no init problems when running CP or AWEMP under Windows 95.
  221.  LAST NEWS: The corrected AWE driver v1.7c for Cubic Player is now available.
  222.  
  223.  
  224.  
  225. SOMETHING ABOUT THE TREBLE SETTING
  226.  
  227.  When playing a module, there are 2 or 3 equalizers in chain:
  228.      1. the digital equalizer in EMU8000
  229.      2. the equalizer in AWE32 mixer (controlled by SB16SET or Windows mixer)
  230.      3. the equalizer in external amplifier
  231.  I think there should be used only last one in chain.  So I decided to set
  232.  the default bass & treble levels of the EMU8000 equalizer to zero.
  233.  But the AWE32 hardware defaults to the treble level approx. +10dB.
  234.  That's why you can hear some loss of high frequencies compared to other AWE32
  235.  players which use the hardware default.
  236.  However, you can use '-Tn' option to change it.
  237.  
  238.  
  239.  
  240. COMMENTS, SUGGESTIONS OR ANYTHING ELSE
  241.  
  242.  My Internet mail address is  kopecky@tsoft.cz
  243.  
  244.  If you use AMP, don't be lazy and send me at least a few words.
  245.  The player is released as freeware and I'd like to know of you :*)
  246.  
  247.  Also the future enhancements depend on feedback I'll get. It's up to you!
  248.